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Renesas Technology America Inc. 


Overview 


This tutorial describes the steps in creating new projects for 
the M16C using two different methods. 


The first method uses the SKP project generator, that will 
create an empty project. 

The second method will provide step by step instructions on 
creating a project with existing source files. 


To get the most out of the SKP including the development 
tools, check out the references at the end of this tutorial. 


Note: This tutorial assumes the user has done the following: 

1. Followed the ‘Quickstart Guide’ 

2. Installed the SKP files, examples, and software tools in the default directories. 
3. Reviewed Tutorial 7. 
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Start HEW 








=] RENESAS-TOOLS 
=) Sony Handheld F 
Sry yao r 










ar High-performance Embedded Workshop 


Manual MH ayvigator : 
Location: C:-\Hew3 


Startup r 
Utilities r 





From the Windows Start menu, click on 
Programs > Renesas High-performance Embedded Workshop> 
High-performance Embedded Workshop 
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igs High-performance Embedded Workshop 
File Edit View Project Options Build Memory Toole Window Help 


[Seaa|S/seeal/o7To||omlp|S|eele ne z 


|| Ei Bl EY A eae | 


Welcome! 





2 Gyles 











Lancel | 9 Cli k 
. Cli n 
1. Ensure , Open a recent project workspace Administration. ‘OK’ ‘ hi 
this option nw! = [EAWTOOLNSKPTOC2E\Gample Code] utton. 


, ae 
IS selected. a ( Browse to another project workspace 


ey Project: FS Templates «| Mavigaton a 


x! 
tho euild fA, bet A, FrdinFhea AA llemkn Contra 


Heady 





When HEW starts up, you will be prompted to select a workspace. By 
default, ‘Create a new project workspace option is selected. 
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Creating a New Project with the 
SKP project generator (1/4) 


Hew Project Workspace 7 7 7 z= 2| x] 





2. Enter ‘Tutor2 pg. 







[ry Empty Application 





1. Select 












te} Import Makefile 

‘M16C/62P Se 

Starter Kit 

Plus as the 3. Select M16C. 

project type. 

4. Verify Renesas 

M16C Standard Is 
selected. 

Note: This is the directory where ok 


the project will be created, 
‘CAHEWS\Tutor2_ pg’. 
9. Click on ‘OK’ button. 
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Creating a New Project with the 
SKP project generator (2/4) 


HM16C/62P Starter Kit Plus - Step 1 


WHat type of proect do you want to 
generate? 


( ‘Yerfy SEP 


These projects allow you to verity the 
SEP and the development environment 


( Sample Code 


sample code for peripherals, memory 1 : Se | ect 
re-write and board components ; ; ; 
Empty Project. 


Empty Project 
Sets up and initializes the M16C62P for | 
this SEP 





2. Click on ‘Next’ 
button. 


e (heel | Next > | tatsth jaa) 


Note: The other project selections (Verify SKP and Sample Code) allow you to 
test the SKP and evaluate the MCU peripherals and features using pre-built 
sample code. 
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Creating a New Project with the 
SKP project generator (3/4) 










H16C/62P Starter Kit Plus - Step 2 
The following files will be added to the 
project: 

: 
detaultsession. Ast HE Sessa... 
main bepskp templa... Main source ... 
nent bepskp. asl Startup code... 
readme. bt Readme text... 
sectil G2pskp. inc Section and ... 
strbep.h SFR defiritic... 
st_bep. as SFA Detiritio... 
skp bep.h Macros for th... 
skp led.c Functions for... 
skp lod. Header File f... 


1. Click on ‘Finish’ 
button. 





€ Back l|__ Next> | Finish | Cancel | 


Note: Step 2 shows all the files that will be added to the new 
project and their description. 
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Creating a New Project with the 
SKP project generator (4/4) 


1. Click on ‘OK’ button. 





The project generator information is shown once the project 


a | has been created. 





== 
= 
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HEW after Creating a New Project using the 
SKP project generator 


igh EmptyProject - High-performance Embedded Workshop 





File Edit Yiew Project Options Build Memoyw Tools Window Help 


jCeb ass Sele r a ||om \a|es |e wo 8 2 | = ||\ay)s J) & ® 









=~ Oy EmptyProject 
Et a Ass mera & file 
~ 2 crt(l a kp.a3 
e aC zn 
rie 0 kp template. 
ae 





. epen 
an oot. 6ops kp.in 
cemeee Str 


= BI tea 


Tprojects | =] tem. 
=| 





| 


= 

a 

| 2|- 
iz 
Zz 
£ 
a 
: 


| 
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SKP project generator 
Summary (1/2) 


The following is a Summary of what happens when creating a new project 
using the SKP project generator Empty Project: 


1. The following files are created in the workspace or project directory (in this 
example, under C:\Hew3\Tutor2_ pg): 
= Acopy of the user startup (ncrtO0Q._ 62pskp.a30 and sect30 62pskp.inc) 
files. 
» A.cfile (main 62pskp template.c) that contains the main function. 
= Copies of the SKP header files (sfr62p.h, skp bsp.h, and skp_Icd.h) 
included in the .c file. 
= Acopy of the sfr_62p.a30 file so SFR labels are visible in KD30. 
2. Links the startup files first as shown in the “Linking the startup files first” slides 
(slides 25 & 26). 
3. Configures the external debugger to launch KD30 as shown in the “Launching 
KD30 from HEW?” slide (slide 28). 
4. Adds the phase to generate a hex file when building a project as shown in the 
slide “Generate a hex file for the Programmer’ (slide 29). 
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SKP project generator 
Summary (2/2) 


P§ Tutor? _pg 


The project structure 
and files created 


File Edit View Favortes Tools Help 


Back + = =] | GSearch [Ay Folders a |S a & y | Eel 


when using the SKP 
project generator are 
shown here. 





“ae Tutore_ pg 


_| BOOTDISE. 
| Cadence 
_| DISCOVER 


| Documents and Settings 


H-{) DRIVERS 
— J flexlrni 
E Hews 
_|) 40C_O5 


_] ADC_Repeat 


4 ETC 
_| help 
_ | Maruals 
_| skptest 
i kaa 
; Ue oo 


‘| Multimedia Files 
_| DACAD WIN 


“J Program Files 
A] SONY'S YS 
(2) TEMP 

E WINNT 





_ | debug 
nen b2pskp. 230 
5] sfr_B2p.a30 


Fal rain bepskp berm... 


skp_ledc 


‘| detaultsession. hst 


‘=a Tutor?_ pg. hwp 
Fal sects bepekp. inc 


Assemblyimnclideil... 


[i] Assemblylistfile. shl 


‘| Assemblysourcetile... 


Cheaderfile. shl 

‘] Clistfile. shl 

‘| Contigurationtile. sh 
Csourcetile. shl 
Default. shl 

F) editordefault. shi 
i] Hexfile. sh 
Linkagemaptile. sh 


‘aa PreprocessedCsou... 


(ai S-Recordtile. hl 


File Folder 
A301 File 
A301 File 
C File 

L File 

H File 

H File 

H File 
HSF File 
HWP File 
INC File 
SHL File 
SHL File 
SHL File 
SHL File 
SHL File 
SHL File 
SHL File 
SHL File 
SHL File 
SHL File 
SHL File 
SHL File 
SHL File 
Text Docurn... 





Creating a New Project Environment 


The SKP project generator simplifies several steps in creating a 
new project but what if you already have source files? The 
following slides will walk you through the following: 


¢ Creating a new workspace from scratch 

¢ Adding source files 

¢ Setting up the software development environment including 
linker, build, debugger, and programming configuration. 
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Creating a New Project (1/8 


select ‘New Workspace’ from the File menu... 





|New Project Workspace ?/ x! 













A See _ 3. Enter “Tutor2’ 
Sean ON cna scsi Toe as name of the 
tel Im ort Maketile . 
@liney — project. 
Tue 


2. Browse to, or enter, 4. Leave as is 


C:\MTOOL\SKP16C62 ee ere (i.e. ‘Tutor2’). 
WaMpie_ 008. hie 5. Select M16C. 


Renesas M1BC Standard = 
6. Select Renesas 


M16C Standard is 
selected. 


pK] Cancel 


7. Click on ‘OK’ button. 
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Creating a New Project (2/8) 





Hew Project-1/6-Select Target CPU_Toolchain ¥ersion Ei EI 


WSS Eritry 1 : 





1. Leave as Is. 


Misc /60 _ 2. Select 
N60 /20 ‘M16C/60’. 


M16C/10 


Rely Tiny 


Other 
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Creating a New Project (3/8) 





Hew Project-27/6-Select RTOS 


1. Select ‘M16C/60’. 
2. Leave asis. 
3. Select ‘USER’, 








FATOS : 





Startup file type : 


Startup files : 


Note: 1. Differences between Default and USER Startup files is 
discussed after the project is created. 


a 





Creating a New Project (4/8) 





‘New Project-3/6-Setting the Contents of Files to be Generated 


P Use lO Library 


Falter eas tere 1. Select ‘None’ as we 

Heap See: already have a file 
with the main() 
function. 
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Creating a New Project (5/8) 
The stack settings are grayed out because USER startup file was 
selected (see Creating a New Project 3/8 ). If DEFAULT startup 
file was selected, these settings become available. 


Hew Project-4/6-Setting the Stack Area Fy x| 


WSS What are the stack sethngs? 
‘ User Stack Pointer: 
Stack Size: 
joso0H 
Interrupt Stack Porter : 
Stack, Size: 
)o200H 


1. Click on ‘Next’ button. 
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Creating a New Project (6/8) 





Hew Project-5/6-Setting the Target System for Debugging 


[ JM theme 


1. Select ‘KD30’. 


Pore 
MI6C Farnly BO30 Y3.20 Release 16 


a ; = — 
o 5 
= ) ll MI6C Family PO30 8.10 Release 1 : 
aS 2. Leave as is. 


3. Click on ‘Next’. 
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Creating a New Project (7/8) 


We already have the source files and selected USER startup files 
(see Creating a New Project 3/8 and 4/8 ) and so, there are no 
source files that will be generated. 





Hew Propect-6/6-Changing the File Names to be Created 


The following source files will be 
generated: 


1. Click on ‘Finish’ 
to complete project 
4 | creation process... 


ext > | Finish | Cancel | 





la by 








oll 


Ih 


: . 
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Creating a New Project (8/8) 


A project summary is displayed to indicate a successful creation of 
the new project, tutor2. 


1. Click on ‘OK’. 
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HEW 





After creating the project, HEW will look similar to the figure below. 


3 Tutor? - High-performance Embedded Workshop |e] 
File Edit View Project Options Build Memory Tools Window Help 





|| ||| ED EF El oF @ 
ee 





Elly! Tutor? 
a Dependencies 





3] Projects | 4] Temp... Maviga... 


x| 
Te 
Read C.-T 
———— ——————— 
—————————— 





Default and User (SKP) Startup Files 


Except for comments, the differences between the default (ncrt0.a30 and 
sect30.inc) and user (ncrt0_62pskp.a30 and sect30_62pskp.inc) startup files 
are listed below: 


Necrt0.a30 

= BCLK - Set to f1 (div by 1) of Xin (BCLK = Xin frequency) in user file. 

Stack sizes — Smaller (0x100) in user file [default at 0x300]. 

Heap size — 0 (no heap size) in user file. 

Vector Base Address — 0xFD000 for (M16C/62P) in user file [default at 

OxFFDOO (M16C/62)] 

= Section Allocation — Calls user sect30 file (sect30_62pskp.inc) [default 
calls default sect30.inc]. 

= Standard I/O Initialization — No initialization in user file (done using 
mcu_init from main()) [default file calls _init routine]. 


Sect30.inc 
= Variable Vector Definition — Simplified and described in user file 
Note: You can use the default startup files but ensure that you understand the how to 


make the necessary modifications. The customized startup files for the SKP can 
be found under C:\MTOOL\SKP16C62P\Sample_Code\Startup_files directory. 
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Adding Source Files (1/2) 


1. From HEW’s Project menu, select Add Files and the Add Files dialog box is 
displayed. 


Add File(s) 


2 ei 2. Browse to C:\MTOOL 
Pelt hod 20 \SKP16C62P 
E5] sect30_tutord. ine \Sample_Code\Tutor2_src 
folder, which contains the 
3. Select main_tutor2.c source codes for this 
and ncrt0O_tutor2.a30. tutorial. 









4. Click on Add. 


File name: “main tutore.c’ “nertltutore. a3" Add 


Files of type: [Project Files | Lancel | 


. Relative Path 





a 
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Adding Source Files (2/2) 


After adding source files, HEW’s workspace will look like the figure below. 


=)x! 










Ey 

ee iy Tutor? 
el, a Assembly source file 
f  daeee (4) ner tutor. as 
EI: a C source file 
| basa 4] main tutore.c 
oF a Dependencies 

beau =) sects0 tutor ine 


y Projects Fe Ternplates | Navigator 





Bey 
I~ Tutor? 


Ey: 












a Assembly source file 

: El 3 nertO_tutore. a30 

_ we =) sects0_ tutor. inc 
4 1.43 C source file 

= oS rain_tutore.c 


1. To display dependencies per source file, right- 
click on the Workspace window, and click on the 
Configure View. 












Configure Yiew 





I Show dependencies under each file 


r Show file paths 


2. Click on check boxes in 
a Configure View dialog box. 
3. Click on OK button. 


Displaying the source file 
dependencies this way makes 
it easier to verify if the header 
files are included before 
building the project. 


strbep.h 
skp bep.h } 
skp led.h 


-y Project: FI Templates ‘| Mavigaton 
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Linking the Startup File First (1/2) 


After checking dependencies, NC30 must be setup to compile and link the startup 


files first. The startup files contain information on memory addresses and sections 
which the linker uses to place the code at the correct addresses. 


1. Select Renesas M16C 


3. Click on Link tab. 
Standard Toolchain from Henesas M16C Standard Toolchain | 
the Option menuand ~~». = == 

: ‘ : . Configuration : C Assembly Link | Librarian: | Lene: Cg | ha | F 
this window is displayed. [al Configuatons 
ontigurations ad Category : lint tst—sés 
Bey All Loaded Projects Show entries for: 
=I-ey Tutor 
(La) © source file Relocatable files 
(9) Assembly source file 
2. Select All 





lrigert... 
Configurations. Remove _| 
5. Click on Add. 4! 4 


Up Down 


4. Select 
Relocatable 


files. 


a [-E] Species start address 

of absolute rnodule : | 
Options Link : 

-L nesblib -G -MS -O 
F(COMFIGDIAYE(PROJECT AAME | x30 








Linking the Startup File First (2/2) 


Add relocatable file [E] 







Relatrve to : | 
1. Select Configuration | | 
directo ' RE [Configuration drectay = 7 
7” File path : 3. Click on OK. 






2. Enter the startup A nertO_ tutor 
source file, i.e. 


nertO_tutor2. 





Henesas M16C Standard Toolchain ?/ x 


Configuration : C | Assembly Link | Librarian | Lme | Chg | ma] | 
[all Configurations ~| Category : [Input | 


Sy All Loaded Projects 
ley Tutors 


#--(lg) C source file [elocatable files -| 


Fl ‘a Assembly source fle || s/c ONFIGDIA)\nertO_tutor?.r30 Add... 
-|E] nertl_tutor2. a3 


ne Default Options Insert... | 


Show entries for : 








[-E] Specifies start address 


of absolute module : | 


Options Link : 


neat -G -MS 7] LU 4. Click on OK. 


SCONFIGDIRN\SIPROUECT NAMIE | #30 , 
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Building (compile & link) the Program 





3 Tutor? - High-performance Embedded Workshop 
File Edit View Project Options Build Memoy Toole Window Help 


josh a |S) s Selo Toll 














DefaultSession 











Debug 





[tT ooo] 
|= EPG Be ee Heh el Er El a 
















El =. Tutor 
Ely Tutor? 


E1- | Assembly source file 
| Eb 2 nertO_tutor?. a30 
=a =] sect30_tutor. inc 
a _— L source file 
=| [3] main_tutore.c 
io sfB2p.h 
| - skp bsp.h 
ie skp ledh 


7S Project: | #1 Templates | Navigator 


[Mcnase HIGC Linker finished =. ==. S!C~=sSC«S.Sst(i‘iSKStS;SttStt Se Phase M1l6C Linker finished 
F 





Look at the Output window and check 


Build Finished 








0 Errors, 0 Warnings whether any errors or warnings occurred. 
AEDS cui A, betos A rindinFes A, verb cond ; 
Ready a a ee ee es 


If there are no errors, try running the program on the SKP16C62P Board using the 
ICD and KD30 Debugger. 


il 






—— 








| 
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Launching KD30 from HEW 


KD30 can be launched directly from HEW, but HEW must be 
configured as shown below. 














1. Select Customize from Customize =| x! 
from the Tools menu. __ eee Debuager |Log | Help | 
. External debugger selected: 
2. Click on Debugger tab | Cither external debugger -| 
3. Select Other exte rnal Debugger settings 
d e b Ul g g er. External debugger locations: 


4 Locate KD30 from CAMTOOLSKD30\K 030 EXE | Browse... | 
C:\AMTOOL\KD30 folder. 


Command line options: 


o. Enter -LOAD=$ -LO4D=$(CONFIGDIRME(PROJECTNAME x30 >| 
(CONFIGDIR)\$(PROJECT 
N AM E) x30 : Download module: 


7 | TOWSe, 
6. Click on OK. 2 coe 





To launch (and download .x30 


file) KD30, click on this icon. 
[Release ~| —— a #t igh | Od [Pe 
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Generate a hex file for the Programmer 


After building a program, a file with an .x30 is generated. For this example, 
‘tutor2.x30’ is generated. This .x30 file can be downloaded using 

KD30. However, device programmers, including the FoUSB 

Programmer, use hex files in Motorola or Intel format. 







Build Phases 
1. To generate a hex file Build Order | Build File Order | File Mappings 
during the build process, ai ans 
select Build Phases from MIMI6C C Compiler Add... | 
the Option menu. ceria Modify. | 
2. Click on M16C Stype EIM8C Jun lable Compose = 
converter checkbox. eal 


With the feature enabled, a hex (.mot) file is created when building the project. 
Look for a Tutor2.mot file under C:\MTOOL\SKP16C62P\Sample_Code\Tutor2\ 
Tutor2\Debug’ folder. 
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End of Tutorial 2 


This is the end of the tutorial. You can try modifying or 
downloading other sample programs from the 
\Sample_ Code directory. 


The completely built tutor2 project can be found in the 
Zip file under C:\MTOOL\Sample_ Code\tutor2_src 
folder. 


Be sure to check out the references on the following 
pages. 


Have Funl! 
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References and Recommended Reading 





¢ SKP16C62P User’s Manual: This is a “must read” document! It details all the 
things you need to know on how to use the Starter Kit. 

¢ HEW User’s Manual: To fully understand and get the most out of HEW. This 
is recommended reading. 

¢ KD30 Version X.XX Help: The tutorial only covered the basics of KD30. 
Check out the Help menu to find out all of KD30’s features. 

¢ NC30 Version X.XX User’s Manual: Check this manual out for features 
specific to the NC30 compiler. 

¢ M16C/62P Datasheet and SKP16C62P Board Schematic: These are 
required to write user application programs. 

¢ RTA-FOUSB-MON User’s Manual: Read this manual to understand how the 
ICD works. 
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References and Recommended Reading 





¢ M16C/10/20/60 Series C Language Programming Manual: This is a great 
document for any level of programmer. The first chapter is an intro to C 
programming. The next chapter explains the memory map of C programs on 
microcontrollers and the role of startup programs. 

¢ M16C/10/20/60 Series Software Manual: This document describes the 
instruction set and timing information for the M16C/20/60 series CPU cores. 

¢ AS30 Version X.XX User’s Manual: Read this manual if you plan on writing 

programs in Assembly or when making changes to the startup file. 

¢ Application Notes and Sample Programs: Application notes and other 
sample programs can be accessed from Renesas Technology America’s 
website: http://www.renesas.com. 





PLATFORM - 
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